home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Utilities / Help / locale / help / english / sys / requestfile.doc < prev    next >
Encoding:
Text File  |  2000-10-06  |  2.4 KB  |  66 lines
  1. REQUESTFILE
  2.  
  3. Allows AmigaDOS and ARexx scripts to use a file requester.
  4.  
  5. Format
  6.  
  7. REQUESTFILE [Drawer <drawer name>] [FILE <file>] [PATTERN <pattern>] [TITLE
  8. <title>] [POSITIVE <text>] [NEGATIVE <text>] [ACCEPTPATTERN <pattern>]
  9. [REJECTPATTERN <pattern>] [SAVEMODE] [MULTISELECT] [DRAWERSONLY] [NOICONS]
  10. [PUBSCREEN <public screen name>]
  11.  
  12. Template
  13.  
  14. DRAWER,FILE/K,PATTERN/K,TITLE/K,POSITIVE/K,NEGATIVE/K,ACCEPTPATTERN/K,REJECTP
  15. ATTERN/K,SAVEMODE/S,MULTISELECT/S,DRAWERSONLY/S,NOICONS/S,PUBSCREEN/K
  16.  
  17. Location
  18.  
  19. C:
  20.  
  21. When entered with no arguments, a file requester with OK, Volumes, Parent,
  22. and Cancel buttons is created. Ist Drawer and File gadgets are empty and it
  23. displays the contents of the current directory.
  24.  
  25. The DRAWER argument specifies the initial contents of the Drawer gadget.
  26.  
  27. The FILE option specifies the initial contents of the File gadget.
  28.  
  29. The PATTERN option allows the use of a standard AmigaDOS pattern. It includes
  30. a Pattern gadget in the requester and specifies the initial contents of the
  31. gadget. If this option is not provided, the file requester does not have any
  32. Pattern gadget.
  33.  
  34. The TITLE option specifies the title of the requester.
  35.  
  36. The POSITIVE option specifies the text to appear in the positive (left)
  37. choice in the file requester.
  38.  
  39. The NEGATIVE option specifies the text to appear in the negative (right)
  40. choice in the file requester.
  41.  
  42. The ACCEPTPATTERN option specifies a standard AmigaDOS pattern. Only files
  43. matching this pattern are displayed in the file requester.
  44.  
  45. The REJECTPATTERN option specifies a standard AmigaDOS pattern. Files
  46. matching this pattern are not displayed in the file requester.
  47.  
  48. If SAVEMODE is specified, the requester is used for writing files to disk. If
  49. MULTISELECT is specified, the requester allows multiple files to be selected
  50. at once. If DRAWERSONLY is specified, the requester does not have a File
  51. gadget. This effectively turns the file requester into a directory requester.
  52. If NOICONS is specified, the requester does not display icons (.info files).
  53.  
  54. The selected files are returned on the command line, enclosed in double
  55. quotation marks and separated with spaces. The command generates a return
  56. code of 0 if you select a file or 5 if you cancel the requester.
  57.  
  58. The PUBSCREEN argument allows the requester to open its window on a public
  59. screen.
  60.  
  61. Example:
  62.  
  63. 1> REQUESTFILE DRAWER Devs: TITLE "My Req" NOICONS
  64.  
  65. Figure 6-2. Sample RequestFile Requester
  66.